---
layout: default
title: Kong Free Trial
breadcrumbs: null
permalink: /free-trial/guide/
body_id: free-trial-guide

---

<style>
@import url('https://fonts.googleapis.com/css?family=Roboto:400,700&display=swap');
@import url('https://fonts.googleapis.com/css?family=Roboto+Mono&display=swap');
body {
  background: #f7f7f7;
}
td {
  border-bottom: none;
}
.main-column {
  max-width: 767px;
  margin: 0 auto;
}
.main-column * {
  margin: 0 auto;
}
.intro {
  margin-top: 133px;
}
.intro h1 {
  color: rgb(0, 75, 128);
  font-family: Roboto;
  font-size: 33px;
  font-weight: normal;
  letter-spacing: 0px;
  text-align: center;
  margin-bottom: 32px;
}
.intro p {
  color: rgba(0, 0, 0, 0.75);
  font-family: Roboto;
  font-size: 18px;
  font-weight: normal;
  letter-spacing: 0px;
  line-height: 27px;
  text-align: center;
  max-width: 602px;
  margin-bottom: 43px;
}
.guide-section {
  background: rgb(255, 255, 255);
  border-radius: 0px;
  max-width: 676px;
  margin-bottom: 48px;
}
.guide-section p {
  max-width: 500px;
  color: rgba(0, 0, 0, 0.75);
  font-size: 14px;
  font-family: Roboto;
  font-weight: normal;
  letter-spacing: 0px;
  line-height: 22px;
  padding-bottom: 24px;
}
.guide-section td p {
  padding: 0;
}
.section-title {
  max-width: 480px;
  color: rgb(0, 75, 128);
  font-size: 22px;
  font-family: Roboto;
  font-weight: 500;
  text-align: center;
  letter-spacing: 0px;
  padding: 48px 0 24px;
}
.prerequisites {
  max-width: 223px;
  margin-top: 24px;
  margin-bottom: 42px;
}
.prerequisites h3 {
  max-width: 97px;
  color: rgba(0, 0, 0, 0.75);
  font-size: 16px;
  font-family: Roboto;
  font-weight: bold;
  letter-spacing: 0px;
}
.prerequisites p {
  max-width: 223px;
  color: rgba(0, 0, 0, 0.75);
  font-size: 14px;
  font-family: Roboto;
  font-weight: normal;
  letter-spacing: 0px;
  line-height: 28px;
  margin-top: 12px;
}
.step {
  max-width: 500px;
  margin-bottom: 18px;
}
.step h3 {
  color: rgba(0, 0, 0, 0.75);
  font-size: 16px;
  font-family: Roboto;
  font-weight: bold;
  letter-spacing: 0px;
  text-align: left;
  padding-bottom: 12px;
}
img.diagram, img.screenshot {
  max-width: 100%;
  margin: 25px 0;
}
.screenshot {
  border: 1px solid #a4a4a4;
}
.subsection {
  margin: 0 32px;
}
.subsection br {
  display: block;
  content: "";
  margin-top: 12px;
}
a {
  text-decoration: none;
}
.code-sample {
  max-width: 500px;
  background: rgb(247, 247, 247);
  border-radius: 0px;
  margin-bottom: 24px;
}
.block {
  max-width: 456px;
  padding: 22px;
  color: rgba(0, 0, 0, 0.75);
  font-size: 14px;
  font-family: Roboto Mono;
  font-weight: normal;
  letter-spacing: 0px;
  line-height: 22px;
}
.highlight-1 {
  color: green;
}
.highlight-2 {
  color: blue;
}
.final {
  padding: 20px 0;
}
.list-content p {
  width: 480px;
}
.bullet-cell {
  padding: 10px 0;
}
.outro h1 {
  max-width: 676px;
  color: rgb(0, 75, 128);
  font-size: 27px;
  font-family: Roboto;
  font-weight: normal;
  text-align: center;
  letter-spacing: 0px;
}
.outro p {
  max-width: 576px;
  color: rgba(0, 0, 0, 0.75);
  font-size: 18px;
  font-family: Roboto;
  font-weight: normal;
  text-align: center;
  letter-spacing: 0px;
  line-height: 27px;
  margin: 32px auto 75px;
}
@media (max-width: 700px) {
  .main-column section>* {
    width: 90%;
  }
}
.demo-button {
  font-size: 15px;
  font-family: Helvetica,Arial,sans-serif;
  color: #ffffff;
  text-decoration: none;
  color: #ffffff;
  text-decoration: none;
  border-radius: 3px;
  padding: 10px 20px;
  border: 1px solid #17a956;
  display: inline-block;
  background-color: rgb(23, 169, 86);
  margin: 42px auto;
}
.button-wrapper {
  display: flex;
}
</style>
<article class='main-column'>
  <section class='intro'>
    <h1>Getting started with your Kong Enterprise trial!</h1>
    <p>Welcome to Kong Enterprise! This guide provides an overview of using Kong Enterprise, and quickly gets you up and running using a full-featured 15-day free trial of Kong Enterprise in the cloud.
      <br>
      <br> The first part of this guide gets you started using Kong Enterprise. If you have any questions, please contact us at <a href="mailto:free-trials@konghq.com">free-trials@konghq.com</a> at any time.</p>
  </section>
  <section class='guide-section'>
    <h2 class="section-title">
      Get started using Kong Enterprise
    </h2>
    <p>
      Get started with Kong Enterprise using the steps in this section to proxy API traffic and enable a Plugin.
    </p>
    <div class='prerequisites'>
      <h3>Prerequisites</h3>
      <p>
        • &nbsp;Your Kong Enterprise trial email
        <br> • &nbsp;A web browser
        <br> • &nbsp;A terminal with cURL installed
      </p>
    </div>
    <div class="step">
      <h3>Step 1: Connect to your trial</h3>
      <p>From the <b>Welcome to your Kong Enterprise trial!</b> email, click the <b>Log in now</b> button. You are connected directly to your Kong Enterprise trial.</p>
    </div>
    <div class="step">
      <h3>Step 2: Proxy API traffic</h3>
      <img class='diagram' src="https://doc-assets.konghq.com/1.3/free-trial/kongproxy.png" alt="a diagram of Kong proxying requests">
      <p>Start to proxy API traffic using a Workspace to set up a Service and a Route.</p>
      <p>1. Use a <b>Workspace</b>. A <em>Workspace</em> is a segmented part of Kong Enterprise that allows a team to access its own entities separately from other teams. The <em>default Workspace</em>  comes with your Kong Enterprise instance, and we’ll
        use this for your trial. </p>
      <p class="subsection">
        a. From the <b>Workspaces</b> tab, click the <b>default</b> Workspace. The <em>default Workspace Dashboard</em> displays.
      </p>
      <p>
        2. Create a <b>Service</b>. A <em>Service</em> is the Admin API entity representing an external <em>upstream</em> API or microservice. For this trial, we’ll name the Service <b>trial-service</b> and use the URL <a href='https://httpbin.org' target='_blank'>https://httpbin.org</a>.
        <em>httpbin</em> is a simple HTTP Request & Response Service that allows you to test traffic.
      </p>
      <p class="subsection">
        a. Click <b>Add a Service</b> in the <em>Services</em> tile. The <em>Create Service</em> page displays.
        <br> b. Enter <b>trial-service</b> in the <em>Name</em> field.
        <br> c. Enter <b>http://httpbin.org</b> in the <em>URL</em> field. The <em>Add using URL</em> is selected by default.
        <br> d. Click <b>Create</b>. The <em>Services details page</em> displays for your new trial-service. This page has information about the Service and any related Routes and Plugins that are connected to the Service.
      </p>
      <p>
        3. Create a <b>Route</b>. A <em>Route</em> is the entity that defines rules to match client requests.
      </p>
      <p class="subsection">
        a. Click <b>Add a Route</b> in the <em>Route</em> tile. The <em>Create Route</em> page displays.
        <br> b. Enter <b>trial-route</b> in the <em>Name</em> field.
        <br> c. Click <b>Add a Path</b> under <b>Path(s)</b> and enter <b>/ </b> in the <em>Path</em> field.
        <br> d. Click <b>Create</b>. The <em>Route details</em> page displays for your new trial-route. This page has information about the Route.
      </p>
    </div>
    <div class="step">
      <h3>Step 3: Add a Plugin on the Service</h3>
      <p>Add a Kong Plugin to extend the functionality of Kong Enterprise. Kong’s Plugin architecture supports a broad range of functionality, such as logging, rate-limiting, authentication, and more.
        <br>
        <br> For this trial, set up Kong’s <em>Rate Limiting Advanced</em> Plugin to rate-limit how many HTTP requests a developer can make in a given period of seconds, minutes, hours, days, months or years. Plugins come pre-installed
        on Kong Enterprise, so all you need to do is enable and configure the Plugin.
        <br>
        <br> 1. Enable the <b>Rate Limiting Advanced</b> Plugin.
      </p>
      <p class="subsection">
        a. On the <b>Plugins</b> tab at the bottom of the page, click <b>Add Plugin</b>. The <em>Add New Plugin</em> page displays.
        <br> b. Scroll down to the <b>Traffic Control</b> section and find the <b>Rate Limiting Advanced</b> plugin. Click <b>Enable</b>. The <em>Create new rate-limiting-advanced</em> plugin page displays with fields partially pre-populated. While there are
        many configuration parameters you can add to this Plugin, as defined in the <a href="https://docs.konghq.com/hub/kong-inc/rate-limiting-advanced/" target="_blank">Rate Limiting Advanced Plugin</a> documentation, in this trial we’ll use the following
        to configure the Plugin:
        <br> c. Scroll to <b>config.limit</b> and enter <b>10, 100</b>
        <br> d. Scroll to <b>config.sync_rate</b> and enter <b>10</b>
        <br> e. Scroll to <b>config.window_size</b> and enter <b>60, 3600</b>
        <br> f. Click <b>Create</b>. The Plugin is configured and enabled.
      </p>
    </div>
    <div class="step">
      <h3>Step 4: Test your setup</h3>
      <p>Test your new Service by issuing the following cURL request to verify Kong is properly forwarding requests to the Service. A successful response means Kong is now forwarding requests made to the Service URL and is forwarding the response back. Kong
        knows to do this through the header defined in the cURL request below.</p>
      <p>1. For the cURL request, enter the following into a terminal window. Be sure to replace &lt;your_trial_ID&gt; with the ID of your trial instance. For example, if the URL of your trial is <b>https://manager-company123.kong-cloud.com</b>, you will
        replace &lt;your_trial_ID&gt; with <b>company123</b>.</p>
      <div class="code-sample">
        <div class="block">
          curl -i -X GET \
          <br> http://&lt;your_trial_ID&gt;.kong-cloud.com/get
        </div>
      </div>
      <p>2. A successful response should look like this:</p>
      <div class="code-sample">
        <div class="block">
          HTTP/1.1 200 OK
          <br> Content-Type: application/json
          <br> Content-Length: 385
          <br> Connection: keep-alive
          <br> X-RateLimit-Limit-minute: 10
          <br> X-RateLimit-Remaining-minute: 9
          <br> X-RateLimit-Limit-hour: 100
          <br> X-RateLimit-Remaining-hour: 68.097777777778
          <br> Access-Control-Allow-Credentials: true
          <br> Access-Control-Allow-Origin: *
          <br> Date: Wed, 13 Nov 2019 18:05:28 GMT
          <br> Referrer-Policy: no-referrer-when-downgrade
          <br> Server: nginx
          <br> X-Content-Type-Options: nosniff
          <br> X-Frame-Options: DENY
          <br> X-XSS-Protection: 1; mode=block
          <br> X-Kong-Upstream-Status: 200
          <br> X-Kong-Upstream-Latency: 3
          <br> X-Kong-Proxy-Latency: 61
          <br> Via: kong/1.3-enterprise-edition
          <br> Kong-Cloud-Request-ID: 5f22acefc395433af3affb5f11ef9e54
          <br>
          <br> {
          <br>   "args": {},
          <br>   "headers": {
          <br>     "Accept": "*/*",
          <br>     "Content-Length": "18",
          <br>     "Content-Type": "application/x-www-form-urlencoded",
          <br>     "Host": "httpbin.org",
          <br>     "User-Agent": "curl/7.54.0",
          <br>     "X-Forwarded-Host": "&lt;your_trial_ID&gt;.kong-cloud.com"
          <br>   },
          <br>   "origin": "127.0.0.1, 54.209.226.208, 127.0.0.1",
          <br>   "url": "https://&lt;your_trial_ID&gt;.kong-cloud.com/get"
          <br> }

        </div>
      </div>
    </div>
    <div class="final step">
      <p>Congratulations! You have just managed your first API using Kong Enterprise.</p>
    </div>
    </div>
  </section>
  <section class="guide-section">
    <h2 class="section-title">
      Explore full features of Kong Enterprise
    </h2>
    <p>Moving beyond Kong Manager, explore other areas of Kong Enterprise.</p>
    <table class="custom-bullet-list">
      <tr>
        <td valign='top' class='bullet-cell'>•&nbsp</td>
        <td class='list-content'>
          <p><b>Kong Proxy</b> evaluates any incoming HTTP request against the Routes you have configured to find a matching one. If a given request matches the rules of a specific Route, Kong processes proxying the request. Because each Route is linked
            to a Service, Kong runs the plugins you have configured on your Route and its associated Service and then proxies the request upstream.</p>
        </td>
      </tr>
      <tr>
        <td valign='top' class='bullet-cell'>•&nbsp</td>
        <td class='list-content'>
          <p><b>Kong Admin API</b> provides a RESTful interface for administration and configuration of Services, Routes, Plugins, Consumers, and Credentials. All of the tasks you performed in the Kong Manager can be automated using the Kong Admin API. </p>
        </td>
      </tr>
      <tr>
        <td valign='top' class='bullet-cell'>•&nbsp</td>
        <td class='list-content'>
          <p><b>Kong Developer Portal</b> (Kong Dev Portal) is used to onboard new developers and to generate API documentation, create custom pages, manage API versions, and secure developer access.</p>
        </td>
      </tr>
      <tr>
        <td valign='top' class='bullet-cell'>•&nbsp</td>
        <td class='list-content'>
          <p><b>Kong Developer Portal API</b> has a feature-rich API reference editor, automatic API explorer, and code generation. All of the tasks you performed in the Kong Manager can be automated using the Kong Developer Portal API. </p>
        </td>
      </tr>
    </table>
    <div class="final step">
      <img src="https://doc-assets.konghq.com/1.3/free-trial/routingdiagram.png" alt="" class="diagram"></div>
  </section>
  <section class="guide-section">
    <h2 class="section-title">Navigating Kong Manager</h2>
    <p>The Kong Manager is a graphical user interface used to manage and configure Kong Enterprise. You can create and manage Workspaces, Services and Routes, activate or deactivate Plugins, and monitor the health of your deployment. </p>
    <table class="custom-bullet-list">
      <tr>
        <td valign='top' class='bullet-cell'>•&nbsp</td>
        <td class='list-content'>
          <p>The <em>Workspaces</em> tab gives an overview of all the Workspaces in your organization. Workspaces enable you to segment traffic so that teams are only able to interact with entities from their groups. You can use the default Workspace or
            create a new Workspace, use the tile or list view to access available Workspaces, and drilldown to a Workspace dashboard. </p>
        </td>
      </tr>
    </table>
    <div class="step">
      <img class="screenshot" src="https://doc-assets.konghq.com/1.3/free-trial/overview.png" alt="">
    </div>
    <table class="custom-bullet-list">
      <tr>
        <td valign='top' class='bullet-cell'>•&nbsp</td>
        <td class='list-content'>
          <p>From a <em>Workspace Dashboard</em>, you can create <em>Services</em> and <em>Routes</em> to proxy API traffic, enable <em>Plugins</em> to extend functionality, and access more features available on Kong Enterprise. </p>
        </td>
      </tr>
    </table>
    <div class="step">
      <img class="screenshot" src="https://doc-assets.konghq.com/1.3/free-trial/workspacedash.png" alt="">
    </div>
    <table class="custom-bullet-list">
      <tr>
        <td valign='top' class='bullet-cell'>•&nbsp</td>
        <td class='list-content'>
          <p>From the <em>Teams</em> tab, you can invite and manage admins and users, as well as assign Workspace roles and permissions. </p>
        </td>
      </tr>
    </table>
    <div class="final step">
      <img class="screenshot" src="https://doc-assets.konghq.com/1.3/free-trial/teamspage.png
" alt="">
    </div>

  </section>
  <section class="outro">
    <h1>Continue your journey with Kong</h1>
    <div class='button-wrapper'>
      <a href="https://konghq.com/request-demo/">
        <div class='demo-button'>Request Demo</div>
      </a>
    </div>
  </section>
</article>
